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NAME 

run-mailcap, view, see, edit, compose, print - execute programs via entries in the mailcap file 

SYNOPSIS 

run-mailcap — action=ACTION [—option[=value]] fMIME-TYPE:[ENCODING:]]FILE [...] 

The see, edit, compose and print versions are just aliases that default to the view, edit, compose, and print 
actions (respectively). 

DESCRIPTION 

run-mailcap (or any of its aliases) will use the given action to process each mime-type/file in turn. Each 
file is specified as its mime-type, its encoding (e.g. compression), and filename together, separated by 
colons. If the mime-type is omitted, an attempt to determine the type is made by trying to match the file’s 
extension with those in the mime.types files. If no mime-type is found, a last attempt will be done by run¬ 
ning the file command, if available. If the encoding is omitted, it will also be determined from the file’s ex¬ 
tensions. Currently supported encodings are gzip (.gz), bzip2 (.bz2), xz (.xz), and compress (.Z). A file¬ 
name ofcan be used to mean "standard input", but then a mime-type must be specified. 

Both the user’s files (“/.mailcap; ~/.mime.types) and the system files (/etc/mailcap; /etc/mime.types) are 
searched in turn for information. 

EXAMPLES 

see picture.jpg 

print output.ps.gz 

compose text/html:index.htm 

extract-mail-attachment msg.txt | see image/tiff: gzip:- 

OPTIONS 

All options are in the form —<opt>=<value>. 

—action=<action> 

Performs the specified action on the files. Valid actions are view, cat (uses only "copiousoutput" 
rules and sends output to STDOUT) , compose, composetyped, edit and print. If no action is 
specified, the action will be determined by how the program was called. 

—debug 

Turns on extra information to find out what is happening. 

—nopager 

Ignores any "copiousoutput" directive and sends output to STDOUT. 

—norun 

Displays the found command without actually executing it. 

SECURITY 

A temporary copy of the file is opened if the file name matches the Perl regular expression "[~[:al- 
num:],in order to protect from the injection of shell commands, and to make sure that the 
name can always be displayed in the current locale. In addition, the file is opened using its absolute path to 
prevent the injection of command-line arguments, for instance using file names starting with dashes. 

SEE ALSO 

filed) mailcap(5) mailcap.order(5) update-mime(8) 

AUTHOR 

run-mailcap (and its aliases) was written by Brian White <bcwhite@pobox.com>. 

COPYRIGHT 

run-mailcap (and its aliases) is in the public domain (the only true "free"). 
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